home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / editor / edit_10.zip / EDIT!.DOC < prev    next >
Text File  |  1993-11-28  |  48KB  |  1,122 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              EdIt! (tm) version 1.0
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                        by
  20.  
  21.                                   Steve Yates
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                   This text and program are Copyright (C) 1993
  58.                                by Steven M. Yates
  59.                          All Rights Reserved Worldwide
  60.  
  61.           EdIt! v1.0                                            Page i
  62.           ------------------------------------------------------------
  63.  
  64.                               Table of Contents
  65.  
  66.           Table Of Contents...................................... i
  67.           Disclaimer & License Agreement........................ ii
  68.           Distribution Information............................. iii
  69.           Definition of Shareware.............................. iii
  70.  
  71.           Installation & Quick Start............................. 1
  72.  
  73.           Product Description.................................... 1
  74.           Why Should I Register?................................. 2
  75.           Ordering Information  ................................. 2
  76.  
  77.           Configuration File..................................... 3
  78.  
  79.           Command Line Operation................................. 3
  80.                Command Line Options.............................. 3
  81.                Command Line Parsing.............................. 4
  82.  
  83.           Editing A File......................................... 5
  84.                Key Bindings...................................... 5
  85.                Selecting Text.................................... 6
  86.  
  87.           Menus And Dialog Boxes................................. 6
  88.                Overview.......................................... 6
  89.                File Menu......................................... 7
  90.                Edit Menu......................................... 8
  91.                Search Menu....................................... 9
  92.                Format Menu....................................... 9
  93.                Window Menu...................................... 11
  94.                Tools Menu....................................... 12
  95.                EdIt! Menu....................................... 13
  96.                Help Menu........................................ 13
  97.  
  98.           Technical Notes & Troubleshooting..................... 13
  99.                Reformatting..................................... 13
  100.                TSRs ............................................ 14
  101.  
  102.           How To Contact The Author ............................ 14
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.           EdIt! v1.0                                           Page ii
  121.           ------------------------------------------------------------
  122.  
  123.             NOTE:  USE OF THIS SOFTWARE CONSTITUTES ACCEPTANCE OF
  124.                    THE FOLLOWING DISCLAIMER & LICENSE AGREEMENT !
  125.  
  126.           DISCLAIMER
  127.           ==========
  128.             Users of EdIt! must accept this disclaimer of warranty:
  129.  
  130.                EdIt! IS SUPPLIED 'AS IS.'  STEVE YATES (AUTHOR)
  131.           DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING,
  132.           WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND
  133.           OF FITNESS FOR ANY PURPOSE.  THE AUTHOR ASSUMES NO
  134.           LIABILITY FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT
  135.           LIMITATION, DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, OR
  136.           OTHER DAMAGES) FOR ANY REASON WHICH MAY RESULT FROM THE USE
  137.           OF OR INABILITY TO USE EdIt!.  ALL RISKS ARE ASSUMED BY THE
  138.           USERS OF THIS SOFTWARE.
  139.  
  140.  
  141.           LICENSE AGREEMENT
  142.           =================
  143.                Read the following terms and conditions carefully.
  144.           Use of this product constitutes your acceptance of these
  145.           terms and conditions and your agreement to follow them.
  146.  
  147.                STEVE YATES (AUTHOR) GRANTS YOU, THE END USER, A
  148.           NONEXCLUSIVE PERSONAL LICENSE TO USE THIS SOFTWARE FOR A
  149.           PERIOD UP TO 30 DAYS IN ORDER TO EVALUATE ITS SUITABILITY
  150.           TO YOUR NEEDS.  AFTER THE EVALUATION PERIOD YOU MUST EITHER
  151.           REGISTER WITH THE AUTHOR OR CEASE USING THE SOFTWARE.  YOU
  152.           MAY USE THE SOFTWARE ON A SINGLE PERSONAL COMPUTER SYSTEM
  153.           AND MAKE AS MANY COPIES AS NEEDED FOR BACKUP AND ARCHIVAL.
  154.           YOU MAY ALSO DISTRIBUTE THE SOFTWARE, UNMODIFIED AND IN ITS
  155.           ENTIRETY, TO OTHERS WHO ARE INTERESTED IN EVALUATING THE
  156.           SOFTWARE AS PER THE FOLLOWING DISTRIBUTION LICENSE.  YOU
  157.           MAY NOT MODIFY, ALTER, TRANSLATE, DISASSEMBLE, DECOMPILE,
  158.           OR LEASE THE SOFTWARE OR THIS MANUAL.  THIS LICENSE IS
  159.           EFFECTIVE UNTIL TERMINATED.  YOU MAY TERMINATE IT AT ANY
  160.           TIME BY DESTROYING THE SOFTWARE.  IT WILL ALSO TERMINATE IF
  161.           YOU FAIL TO COMPLY WITH ANY TERM OR CONDITION OF THIS
  162.           AGREEMENT.  YOU AGREE UPON SUCH TERMINATION TO DESTROY THE
  163.           SOFTWARE.  THIS AGREEMENT SHALL BE GOVERNED BY THE LAWS OF
  164.           THE STATE OF ILLINOIS.
  165.  
  166.                EdIt! is a "Shareware" program (see note below) and is
  167.           provided at no charge to the user for evaluation.  Feel
  168.           free to share this evaluation copy with your friends, but
  169.           you may not give it away altered or as part of another
  170.           system.  The essence of "user-supported" software is to
  171.           provide personal computer users with quality software
  172.           without high prices, and yet provide incentive for
  173.           programmers to continue to develop new products.
  174.  
  175.                If you find this program useful and find that you are
  176.           using EdIt! and continue to use EdIt! after a 30-day trial
  177.           period, you must register with the author.
  178.  
  179.           EdIt! v1.0                                          Page iii
  180.           ------------------------------------------------------------
  181.  
  182.                The $20 registration fee will license one copy for use
  183.           on any one computer at any one time.  You must treat this
  184.           software just like a book, i.e., this software may be used
  185.           by any number of people and may be freely moved from one
  186.           computer location to another, so long as there is NO
  187.           POSSIBILITY of it being used at one location while it is
  188.           being used at another, just as a book cannot be read by two
  189.           different persons at the same time.  Volume discounts and
  190.           site-licensing information is available in the Ordering
  191.           Information section on page 2.
  192.  
  193.                You are encouraged to pass an evaluation copy of
  194.           EdIt! along to your friends for evaluation.  Please
  195.           encourage them to register their copy if they find that
  196.           they continue to use it.  All registered users will receive
  197.           a copy of the latest 1.x version of EdIt!, along with the
  198.           other registration benefits outlined below, on page 2.
  199.  
  200.  
  201.  
  202.           DISTRIBUTION LICENSE AND INFORMATION
  203.           ====================================
  204.                You are hereby granted a limited license to freely
  205.           distribute the evaluation version of EdIt!, subject to the
  206.           following terms and conditions.  Any other use,
  207.           distribution or representation of EdIt! is expressly
  208.           forbidden without the express written consent of the author.
  209.  
  210.             (1) EdIt!, its documentation, and accompanying files may
  211.                 not be altered under any circumstances, and must be
  212.                 distributed as a complete unit.  Please contact
  213.                 the author for information on obtaining a complete
  214.                 copy of the latest version for evaluation and
  215.                 distribution if yours is incomplete or has been
  216.                 modified.
  217.  
  218.             (2) Under no circumstances must the purchaser or receiver
  219.                 of the software be given the impression that he/she
  220.                 is buying or receiving a license to use the software
  221.                 itself, but merely an evaluation copy.
  222.  
  223.             (3) Any disputes concerning this software shall be
  224.                 resolved subject to the applicable laws of the United
  225.                 States of America and the State of Illinois.
  226.  
  227.             (4) Failure to abide by these provisions constitutes
  228.                 violation of U.S. federal copyright laws, and will be
  229.                 prosecuted to the maximum extent possible.
  230.  
  231.  
  232.  
  233.           DEFINITION OF SHAREWARE
  234.           =======================
  235.                First, let's consider what Shareware is not.
  236.           Shareware is NOT "free" or "public domain" software, it is
  237.  
  238.           EdIt! v1.0                                           Page iv
  239.           ------------------------------------------------------------
  240.  
  241.           a type of distribution method designed to lower costs for
  242.           everyone involved.  Any fee that you may have paid to
  243.           obtain this or any Shareware program from a disk vendor,
  244.           computer bulletin board service, user group, or retailer
  245.           was to cover their cost of getting the program to you.
  246.           Shareware is paid for by registering with the author.
  247.  
  248.                Shareware distribution gives users a chance to try
  249.           software before buying it.  If you try a Shareware program
  250.           and continue using it, you are expected to register.
  251.           Individual programs differ on details -- some request
  252.           registration while others require it; some specify a
  253.           maximum trial period.  With registration, you get anything
  254.           from the simple right to continue using the software to an
  255.           updated program with printed manual.
  256.  
  257.                Copyright laws apply to both Shareware and commercial
  258.           software, and the copyright holder retains all rights, with
  259.           a few specific exceptions as stated below.  Shareware
  260.           authors are accomplished programmers, just like commercial
  261.           authors, and the programs are of comparable quality (in
  262.           both cases there are good programs and bad ones!).  The
  263.           main difference is in the method of distribution.  The
  264.           author specifically grants the right to copy and distribute
  265.           the software, either to all and sundry or to a specific
  266.           group.  For example, some authors require written
  267.           permission before a commercial disk vendor may copy their
  268.           Shareware.
  269.  
  270.                Again, Shareware is a distribution method, not a type
  271.           of software.  You should find software that suits your
  272.           needs and pocketbook, whether it is commercial or
  273.           Shareware.  The Shareware system makes fitting your needs
  274.           easier, because you can try the software *before* you buy.
  275.           And because the overhead is low, prices are low also.
  276.           Shareware has the ultimate money-back guarantee:  if you
  277.           don't use the product, you don't pay for it.  Without
  278.           product registrations, however, programmers receive no
  279.           compensation for their work and thereby are not encouraged
  280.           to continue developing software.  They have trusted you by
  281.           providing a full-featured product, and they expect you to
  282.           reciprocate that trust.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.           EdIt! v1.0                                            Page 1
  298.           ------------------------------------------------------------
  299.  
  300.           INSTALLATION & QUICK START
  301.           ==========================
  302.                Please see the ED-READ.ME file for a list of exactly
  303.           which files should be included in this archive.  If it is
  304.           missing, your copy of EdIt! is incomplete or has been
  305.           modified.
  306.  
  307.                To install EdIt!, you only need to copy all the files
  308.           included in this archive to a directory that is on your
  309.           PATH (type PATH at the DOS prompt to display your PATH; to
  310.           find out more about your PATH statement, consult your DOS
  311.           manual).  This way, EdIt! can be run from any directory or
  312.           disk drive.  That's it!
  313.  
  314.                For those of you who prefer a "quickie" approach to
  315.           new software, type ED /? at the DOS prompt for a one-page
  316.           command summary, or ED to jump right into the program.  It
  317.           is my hope that EdIt! is easy enough to learn without
  318.           reading this manual.
  319.  
  320.  
  321.           JUST WHAT IS EdIt!, ANYWAY?
  322.           ===========================
  323.                EdIt! is a small, fast replacement for the editor from
  324.           DOS 5.0 and later (and the infamous EDLIN from earlier DOS
  325.           versions!) with the following features and benefits (and
  326.           many more):
  327.  
  328.              * Potentially save hours of time updating files on LANs
  329.              * LANtastic network support (NET USE, NET, NET_MGR)
  330.              * Ability to open multiple files and groups of files
  331.                from the command line (wildcards allowed)
  332.              * Windowed interface (written in Borland's Turbo Vision)
  333.              * Mouse support
  334.              * Small size -- 119k total! (less than 1/3 that of DOS's
  335.                EDIT & QBASIC combination, 1/4 the size of Boxer 5.0,
  336.                and 1/11 the size of VED 3.31!)
  337.              * Fast; written in Turbo Pascal and assembler, not BASIC
  338.              * Does not require QBASIC.EXE to run, as does DOS's EDIT
  339.              * Wordwrap
  340.              * Paragraph and document reformatting
  341.              * Variable right margin & tab stop settings
  342.              * Auto-indent mode
  343.              * Text can be centered
  344.              * Ability to jump to specific line numbers and "preset"
  345.                locations in documents
  346.              * Undo
  347.              * Search & replace
  348.              * Clipboard (cut, copy and paste)
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.           EdIt! v1.0                                            Page 2
  357.           ------------------------------------------------------------
  358.  
  359.           WHY SHOULD I REGISTER?
  360.           ======================
  361.                There are several registration incentives.  First and
  362.           foremost, you will know that you are doing the right (and
  363.           legal!) thing by paying for the software you use.  When you
  364.           register, you will also receive:
  365.  
  366.                * The latest 1.x version of EdIt!, encoded with your
  367.                  name and serial number.
  368.                * A discount on future versions (typically half price)
  369.                * Your version can be optimized for '286+ computers
  370.                  (see note on page 3)
  371.                * No "reminder" screens
  372.                * Notification of the release of new versions
  373.                * When upgrading, registered users will receive a
  374.                  conversion program to convert the EDIT!.CFG file, if
  375.                  necessary
  376.  
  377.                I would like to ask that if you decide not to register
  378.           and discontinue using EdIt!, please send me a postcard
  379.           letting me know why, so that I may implement your
  380.           suggestions in future versions.
  381.  
  382.  
  383.  
  384.           ORDERING INFORMATION
  385.           ====================
  386.                To order EdIt!, please use the ordering form.  To
  387.           print this form, simply choose "Print Registration Form..."
  388.           from the Help menu.
  389.  
  390.                Mail the registration form to the following address
  391.           (please do not try to call, as I will not be there):
  392.  
  393.                      Steve Yates
  394.                      279 Main Street
  395.                      Glen Ellyn, IL  60137-5353
  396.  
  397.                Pricing for EdIt! is as follows.  These prices will be
  398.           good for all 1.x releases of EdIt!.  All prices are in U.S.
  399.           Dollars, so please make all checks out in this currency.
  400.           Please note that there is a surcharge of $5.00 for all
  401.           checks drawn on banks outside the U.S.  and Canada, to help
  402.           offset my added cost.  It probably will also take longer
  403.           for these checks to clear.  Please add $2.00 shipping to
  404.           all orders, and allow 3 weeks for delivery.
  405.  
  406.                     Number of Users          Price Per Copy
  407.                     ---------------          --------------
  408.                             1                   $ 20.00
  409.                             2                     18.00
  410.                      up to  5                     16.00
  411.                      up to 10                     14.00
  412.                      up to 25                     12.00
  413.                      site license (unlimited)    400.00
  414.  
  415.           EdIt! v1.0                                            Page 3
  416.           ------------------------------------------------------------
  417.  
  418.                Registered users have the option of receiving a
  419.           version compiled for 80286 processors.  This version will
  420.           run slightly faster on the 80286 and above family of
  421.           processors, and is slightly smaller.  However, it will NOT
  422.           run on 8086 or 8088 machines (mostly early IBM PCs and
  423.           clones).  If you are not sure which type of machine you
  424.           have or will be using EdIt! in various locations or on a
  425.           network, do not choose this option.
  426.  
  427.  
  428.  
  429.           CONFIGURATION FILE
  430.           ==================
  431.                Upon startup, EdIt! will search for its EDIT!.CFG
  432.           file.  EdIt! looks first for an environment variable called
  433.           EDIT! to point it to the proper directory (SET EDIT!=C:\).
  434.           This is done to facilitate multiple configurations--on a
  435.           network, for example.  If the EDIT! variable is not found,
  436.           EdIt! looks in the current directory, then in order through
  437.           the user's PATH statement.  If no config file is found,
  438.           EdIt! will still run, but revert to its default
  439.           configuration (the same as the first time you ran EdIt!).
  440.           Similarly, if a corrupted EDIT!.CFG (or one created by a
  441.           different version of EdIt!) is found, EdIt! will display
  442.           its pathname, warn the user to remove it, and revert to its
  443.           default configuration.
  444.  
  445.  
  446.  
  447.           COMMAND LINE OPERATION
  448.           ======================
  449.  
  450.           Command Line Options
  451.           --------------------
  452.                Currently there are only seven command line options,
  453.           or switches, for EdIt!, which may be used in any order and
  454.           may be either upper or lower case.  The only exception is
  455.           the one to display the help screen, "/?", which must be
  456.           placed first (as in "ED -?").  Options must be prefixed
  457.           with a "-" or "/", with a space between options.  The rest
  458.           of the options are:
  459.  
  460.             /S:   On startup, opens \AUTOEXEC.BAT and \CONFIG.SYS in
  461.                 the root directory of the default drive (the default
  462.                 is the current drive, unless specified otherwise
  463.                 using the /D option, below).
  464.  
  465.                (Typing a backslash ("\") before any file or directory
  466.                name as indicated above indicates that the pathname
  467.                begins in the root directory of the drive; i.e.,
  468.                \UTIL\ED.EXE is the same as C:\UTIL\ED.EXE, assuming
  469.                you are on drive C:)
  470.  
  471.  
  472.  
  473.  
  474.           EdIt! v1.0                                            Page 4
  475.           ------------------------------------------------------------
  476.  
  477.             /W:   On startup, opens \AUTOEXEC.BAT, \CONFIG.SYS,
  478.                 \[Your_Windows_Dir]\WIN.INI and
  479.                 \[Your_Windows_Dir]\SYSTEM.INI.  EdIt! reads its
  480.                 EDIT!.CFG file upon startup to learn what you have
  481.                 set as your Windows directory (in EdIt!, select
  482.                 Tools|Configuration... to set this directory).
  483.  
  484.           /[#]:   On startup, opens the four files specified in the
  485.                 specified file group (#1, #2, #3, or #4).  In EdIt!,
  486.                 select Tools|Configuration... to set these
  487.                 filenames (see Tools|Configuration, below, for more
  488.                 information).
  489.  
  490.            /Dd:   Changes the default drive to drive "d".  The default
  491.                 drive is the current drive unless otherwise specified
  492.                 by this option.  This is true both for the above
  493.                 command line options and for their equivalents in the
  494.                 program (see the EdIt! menu).  EdIt! attempts to make
  495.                 sure your choice of drives is valid by accessing the
  496.                 NUL file in the root directory.  With this option,
  497.                 users can set each drive letter to a different server,
  498.                 for example, to easily update files across a network
  499.                 with the file groups discussed above.
  500.  
  501.  
  502.           Command Line Parsing
  503.           --------------------
  504.                Upon startup, EdIt! first checks to see if the first
  505.           command line option (if present) is "/?".  If so, it
  506.           displays the help screen and quits.
  507.  
  508.                If not, the program checks to see if a default drive
  509.           was specified using the "/Dd" option, and validates it (see
  510.           Command Line Options).  If two or more "/D"s are specified
  511.           on one line, EdIt! will end up using the last one to set
  512.           the default drive.
  513.  
  514.                Next, EdIt! will process the command line in order
  515.           from left to right, opening any valid filenames found
  516.           and/or processing any command line options.  Remember,
  517.           wildcards are perfectly OK!  EdIt! will not open any
  518.           executable files (EXE/COM) or archive files (ZIP/ARJ/ARC/
  519.           PAK/ZOO/LZH), as they (along with any binary file) will
  520.           probably be corrupted if modified and Saved by EdIt!.  This
  521.           is also to allow better use of the command line "ED *.*" in
  522.           a directory with these files.
  523.  
  524.                Finally, EdIt! will cascade all open windows on the
  525.           desktop for easy selection.  Note that after eighteen
  526.           windows are open there is no more space in which to cascade
  527.           them; in this event, the remaining windows are opened full
  528.           screen (memory permitting, of course).
  529.  
  530.  
  531.  
  532.  
  533.           EdIt! v1.0                                            Page 5
  534.           ------------------------------------------------------------
  535.  
  536.           EDITING A FILE
  537.           ==============
  538.  
  539.           Key Bindings
  540.           ------------
  541.                In general, there are two "rules" to EdIt!'s hotkeys.
  542.           First, there are at least two keys for almost everything.
  543.           Second, if you know of a hotkey combination, try it--it
  544.           probably works (if it doesn't, let me know about it...if
  545.           enough people ask, I will change it in future versions).
  546.  
  547.                 I have tried to make the key choices as logical as
  548.           possible, and every menu option has its hotkey displayed.
  549.           Keys are bound to some of the traditional WordStar key
  550.           bindings, although a few changes had to be made (the block
  551.           and cut/copy/paste commands come to mind).  Below is a list
  552.           of the key bindings in EdIt!:
  553.  
  554.           Control+  Command             Control-K +  Command
  555.           --------  ---------           -----------  ---------
  556.             A       Set tab stops           #        Set place marker
  557.             B       Reformat paragraph      B        Start select
  558.             C       Copy                    C        Paste
  559.             D       Reformat document       D        Save
  560.             E       Center text             F        SaveAs
  561.             F       Find                    H        Hide selection
  562.             G       Find again              K        Copy
  563.             H       Backspace               S        Save
  564.             I       Toggle autoindent       T        Select word
  565.             L       Jump to line number     Y        Cut
  566.             M       Set right margin        X        Save & close file
  567.             N       Insert line
  568.             P       Insert page break   Control-J +  Command
  569.             R       Replace             -----------  ---------
  570.             T       Delete word             #        Jump to marker
  571.             U       Undo
  572.             V       Paste               Control-S +  Command
  573.             W       Toggle wordwrap     -----------  ---------
  574.             X       Cut                     #        Set place marker
  575.             Y       Delete line
  576.             Left    Left one word       Control-Q +  Command
  577.             Right   Right one word      -----------  ---------
  578.             Home    Top of page             #        Jump to marker
  579.             End     Bottom of page          A        Replace
  580.             PgUp    Start of document       C        End of document
  581.             PgDn    End of document         D        End of line
  582.            BkSpace  Delete to line start    F        Find
  583.             Delete  Clear                   H        Del to line start
  584.                                             I        Toggle AutoIndent
  585.                                             L        Undo
  586.                                             R        Start of document
  587.                                             S        Start of line
  588.                                             U        Reformat document
  589.                                             Y        Del to line end
  590.  
  591.  
  592.           EdIt! v1.0                                            Page 6
  593.           ------------------------------------------------------------
  594.  
  595.           Selecting Text
  596.           --------------
  597.                The selection can be started by holding down the shift
  598.           key with any of the cursor movement commands, or via the
  599.           mouse.  For those of you familiar with WordStar's block
  600.           commands, they are simulated by copying the information to
  601.           and from the clipboard.  For example, ^K^B will begin
  602.           selecting text.  ^K^K will copy the text to the clipboard.
  603.           ^K^C will paste the contents from the clipboard to the
  604.           editor.  This simulates, quite closely, the keystrokes to
  605.           do the same thing using WordStar bindings.  If text is
  606.           inserted into the editor, either through a key press or
  607.           pasting from the clipboard, the contents of the selection
  608.           are replaced by the inserted text.  If there is no
  609.           selection, the text is inserted at the cursor position.
  610.  
  611.  
  612.  
  613.           MENUS AND DIALOG BOXES
  614.           ======================
  615.  
  616.           Overview
  617.           --------
  618.                The menu bar, as well as elements in dialog boxes, may
  619.           be selected quickly by simultaneously pressing ALT and the
  620.           highlighted letter of the menu you wish to use.  Menu
  621.           choices may be selected by pressing the highlighted letter
  622.           or by using the arrow keys.  Those menu choices that have
  623.           hot keys have them listed (in general, those hot keys
  624.           having to do with file or global/system operations use the
  625.           ALT key, while text and formatting hot keys use the CTRL
  626.           key).  The F10 key will also activate the menu bar.
  627.  
  628.                In EdIt!'s dialog boxes, the default button is
  629.           highlighted, and will be pressed upon hitting Enter in the
  630.           dialog.  In most cases, the default is the OK button.  As
  631.           is true throughout EdIt!, highlighted text in dialog boxes
  632.           will be replaced upon typing.  Pressing Escape will always
  633.           clear and cancel the dialog box.  The presence of an arrow
  634.           next to an input line indicates a history list for that
  635.           line, which can be accessed by pressing it with the mouse
  636.           or pressing the down arrow.  The history list stores the
  637.           previous entries for that line during the current execution
  638.           of EdIt! (it is not stored between sessions).
  639.  
  640.                For consistency, all references to menus will be made
  641.           using vertical bars, i.e., File|Open indicates the Open
  642.           choice under the File menu.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.           EdIt! v1.0                                            Page 7
  652.           ------------------------------------------------------------
  653.  
  654.           FILE MENU:
  655.  
  656.           File|Open
  657.           ---------
  658.                This dialog may be opened by the ALT-O hot key, the
  659.           menu choice, or the "Alt-O:Open" option on the status line
  660.           using the mouse.  The directory list will display all files
  661.           in the directory using the "*.*" mask.  This mask may be
  662.           changed temporarily by changing the "Name" line in the
  663.           dialog and pressing Enter.  The default button is the OK
  664.           button, and the lower portion of the dialog displays the
  665.           current directory and file information for the highlighted
  666.           file.  You may switch drives by typing the drive letter (or
  667.           drive and pathname, if you wish) in the "Name" field.  Note
  668.           that any files to be opened must be less than 65520 bytes
  669.           in size; this is because EdIt! currently opens each file
  670.           into an array, and arrays are limited to 64 KB in size.
  671.  
  672.  
  673.           File|Save
  674.           ---------
  675.                Saves the file in the active window.
  676.  
  677.  
  678.           File|Save As...
  679.           ---------------
  680.                Works just like the File|Open dialog, above.
  681.  
  682.  
  683.           File|Save All
  684.           -------------
  685.                Saves all open files.
  686.  
  687.  
  688.           File|Close
  689.           ----------
  690.                Closes the file in the active window, prompting the
  691.           user to save any changes.  This item may be chosen by the
  692.           ALT-C hot key, the menu choice, or the "Alt-C:Close" option
  693.           on the status line using the mouse.
  694.  
  695.  
  696.           File|Close All
  697.           --------------
  698.                Closes all open files.
  699.  
  700.  
  701.           File|Change Dir...
  702.           ------------------
  703.                This dialog changes the current directory used for
  704.           opening and saving files, to avoid having to repeatedly
  705.           change directories in the File|Open and File|Save As
  706.           dialogs.  While this dialog's buttons may not be
  707.           immediately obvious, it will be easier to understand once
  708.           you know what each button/element does.  The "Directory
  709.  
  710.           EdIt! v1.0                                            Page 8
  711.           ------------------------------------------------------------
  712.  
  713.           Name" input line allows the user to type in the directory.
  714.           The "Directory Tree" allows the user to manually select the
  715.           desired directory using the mouse or keyboard; "Drives"
  716.           displays a list of available drives.  The "Chdir" button
  717.           changes to the highlighted directory, while the "OK" button
  718.           confirms that choice and exits the dialog (double-clicking
  719.           the mouse in the Directory Tree has the same effect as the
  720.           "Chdir" button).  "Revert" changes the "Directory Tree"
  721.           back to the way it was when the dialog was first opened.
  722.  
  723.  
  724.           File|Print
  725.           ----------
  726.                This dialog prints either the whole file or a
  727.           highlighted section to the selected port.  An error will
  728.           occur if an attempt is made to print to a port that does
  729.           not exist; however port redirection should be no problem.
  730.           If the printer does not respond, Turbo Vision generates an
  731.           internal error marked by a red band across the bottom of
  732.           the screen.  If this occurs, press "Enter" to continue, or
  733.           "Esc" to exit.  Note that EdIt! does not format the output
  734.           in any way, merely sending the ASCII text to the printer
  735.           directly.  There is an option to send a form feed after
  736.           printing, which is the default.
  737.  
  738.  
  739.           File|DOS Shell
  740.           --------------
  741.                This choice will shell to DOS using whichever command
  742.           processor is present on your COMSPEC environment variable
  743.           (if you don't know what this is, don't worry about it).  If
  744.           you start getting out-of-memory errors when running
  745.           programs this may be an indication you have shelled to DOS
  746.           from within another program.  4DOS users also note that
  747.           4DOS initally requires more memory (on the order of 80-90
  748.           KB free) to shell to DOS than does COMMAND.COM.
  749.  
  750.  
  751.           File|Exit
  752.           ----------
  753.                Closes all windows, prompting to save changes, then
  754.           exits the program.  This command may be executed via the
  755.           ALT-X hot key, the menu choice, or the "Alt-X:Exit" option
  756.           on the status line using the mouse.
  757.  
  758.  
  759.           EDIT MENU:
  760.  
  761.           Edit|Undo
  762.           ---------
  763.                "Undo" will only undo all operations done between
  764.           cursor movements, so as soon as the cursor moves (by the
  765.           cursor keys, etc.), the edits performed are considered
  766.           "accepted" and all undo information is lost. Note that this
  767.           feature cannot undo wordwrap-related operations.
  768.  
  769.           EdIt! v1.0                                            Page 9
  770.           ------------------------------------------------------------
  771.  
  772.           Edit|Cut / Copy / Paste / Clear
  773.           -------------------------------
  774.                EdIt! uses both the DOS/Windows 3.0 standard of
  775.           SHIFT-DELETE, CTRL-INSERT, and SHIFT-INSERT as well as the
  776.           Windows 3.1/Macintosh standard of CTRL-X, CTRL-C, and
  777.           CTRL-V for the Cut, Copy, and Paste hot keys,
  778.           respectively.  The easiest way to think of Edit|Clear is as
  779.           "delete," or "cutting without copying to the clipboard."
  780.  
  781.  
  782.           Edit|Show Clipboard
  783.           -------------------
  784.                The clipboard contains the last block of text cut or
  785.           copied to it.  This choice is present in case the user
  786.           wishes to paste only part of what was Cut or Copied, or
  787.           wishes to recover text previously Cut out of the file.
  788.           Remember that the text in the clipboard must be highlighted
  789.           for Pasting to occur.
  790.  
  791.  
  792.           SEARCH MENU:
  793.  
  794.           Search|Find / Replace / Find Again
  795.           ----------------------------------
  796.                The "Find" and "Replace" dialog boxes will search for
  797.           (and replace) a text string, starting at the beginning of
  798.           the document.  "Find Again" will continue searching for
  799.           last searched-for string from the current cursor position.
  800.           To execute a search-and-delete, do not specify anything in
  801.           the "New Text" input line, and found text will in effect be
  802.           replaced with nothing.
  803.  
  804.  
  805.           Search|Set Jump Marker / Jump To Marker
  806.           ---------------------------------------
  807.                These commands allow the user to invisibly select 10
  808.           "preset" locations or place markers within a document, then
  809.           later Jump To them.  This feature provides an easy way to
  810.           jump back and forth between sections of a document.
  811.  
  812.  
  813.           FORMAT MENU:
  814.  
  815.           Format|Toggle WordWrap
  816.           ----------------------
  817.                Toggles the wordwrap feature for the active window on
  818.           and off.  The default is off; its status is indicated by a
  819.           "W" in the lower left-hand corner.  The wordwrap feature
  820.           depends on the current location of the cursor, meaning that
  821.           while typing the "wrap" takes place when the cursor reaches
  822.           the right margin.
  823.  
  824.  
  825.  
  826.  
  827.  
  828.           EdIt! v1.0                                           Page 10
  829.           ------------------------------------------------------------
  830.  
  831.           Format|Toggle AutoIndent
  832.           ------------------------
  833.               Toggles the wordwrap feature for the active window on
  834.           and off.  The default is off; its status is indicated
  835.           by an "A" in the lower left-hand corner.  When in
  836.           AutoIndent mode, paragraph reformatting will end at the
  837.           first blank line (see Format|Reformat Paragraph, below).
  838.  
  839.  
  840.           Format|Center Text
  841.           ------------------
  842.                Centers the current line with respect to the document's
  843.           current right margin setting.  Wordwrap does not have to be
  844.           on.
  845.  
  846.  
  847.           Format|Insert Page Break
  848.           ------------------------
  849.                Inserts a page break (form feed) control character (an
  850.           ASCII #12 decimal, #0C hex) at the current cursor location.
  851.           This will not print, but will send a form feed to the
  852.           printer.
  853.  
  854.  
  855.           Format|Set Tab Stops
  856.           --------------------
  857.                Brings up the tab settings dialog.  The x's indicate
  858.           the location of the stops, i.e., the first stop is in
  859.           column six, so from the left margin upon hitting TAB the
  860.           cursor moves five spaces and stops in column six.  To move
  861.           the tab stop locations, just change the location of the
  862.           x's.
  863.  
  864.  
  865.           Format|Set Right Margin
  866.           -----------------------
  867.                Allows the user to define the right margin for the
  868.           active window, which is used for the wordwrap, centering,
  869.           and reformatting features.
  870.  
  871.  
  872.           Format|Reformat Paragraph
  873.           -------------------------
  874.                Reformats the current paragraph to fit to the right
  875.           margin, starting from the line the cursor is on.  The
  876.           "current paragraph" is considered to end at the first line
  877.           beginning with a tab or space character, or the first blank
  878.           line.  Note that it is easy to indent blocks of text by
  879.           indenting the first line and turning on the AutoIndent
  880.           feature before reformatting that paragraph; however, the use
  881.           of AutoIndent mode automatically causes EdIt! to default to
  882.           having the "current paragraph" end only at the first blank
  883.           line.  Reformatting will work even if WordWrap is off at the
  884.  
  885.  
  886.  
  887.           EdIt! v1.0                                           Page 11
  888.           ------------------------------------------------------------
  889.  
  890.           time.  It will not work, however, if the first word on the
  891.           line is beyond the right margin.
  892.  
  893.           (see "Technichal Notes/Troubleshooting," below)
  894.  
  895.  
  896.           Format|Reformat Document
  897.           ------------------------
  898.                Reformats the document paragraph by paragraph as
  899.           above, optionally starting from the current line.
  900.  
  901.  
  902.           WINDOW MENU:
  903.  
  904.           Window|Size/Move
  905.           ----------------
  906.                Allows the user to move the active window via the
  907.           arrow keys, and also allows resizing of the window by
  908.           holding down SHIFT and using the arrow, HOME, END, PageUp,
  909.           and PageDown keys.
  910.  
  911.  
  912.           Window|Zoom
  913.           -----------
  914.                Toggles the active window between full screen and the
  915.           current size, or whatever size at which the window was
  916.           originally opened.
  917.  
  918.  
  919.           Window|Tile
  920.           -----------
  921.                Tiles all open windows, allowing as much as possible
  922.           of each window to show, i.e., if four windows are open,
  923.           each would receive a fourth of the screen.  After 12 or so
  924.           windows are open, some begin to overlap due to the minimum
  925.           window size requirements.
  926.  
  927.  
  928.           Window|Cascade
  929.           --------------
  930.                Stacks the windows, allowing the title bar and left
  931.           border of each to be seen.  The active window at the time
  932.           of the cascade is placed on top.
  933.  
  934.  
  935.           Window|Next / Previous
  936.           ----------------------
  937.                Switches to the next/previous window.
  938.  
  939.  
  940.           Window|Close
  941.           ------------
  942.                See "File|Close".
  943.  
  944.  
  945.  
  946.           EdIt! v1.0                                           Page 12
  947.           ------------------------------------------------------------
  948.  
  949.           Window|Close All
  950.           ----------------
  951.                See "File|Close All".
  952.  
  953.  
  954.           TOOLS MENU
  955.  
  956.           Tools|Toggle 43/50-Line Video
  957.           -----------------------------
  958.                Toggles between 25-line and 43/50-line video mode for
  959.           EGA and VGA displays.  Has no effect on other displays.
  960.  
  961.  
  962.           Tools|Configuration
  963.           -------------------
  964.                This dialog allows the user to choose which files will
  965.           be used as Group files, as well as the path in which EdIt!
  966.           should find the WIN.INI and SYSTEM.INI files.  You can use
  967.           these groupings to open up to four files at once.  It is OK
  968.           to specify drive letters in the input lines, and filenames
  969.           from each group may be left blank.  Groups 1 and 2 have four
  970.           files each already in order to provide an example.  I had
  971.           originally intended EdIt! for use by my father's consulting
  972.           firm, Integrated Technical Solutions, which is an Artisoft
  973.           LANtastic Five-Star Dealer, so the filenames for Group 1
  974.           are the ones they usually use.  AUTOLAN.BAT is called from
  975.           AUTOEXEC.BAT to start the network, the next two are for
  976.           "small" servers and print servers, respectively, and
  977.           STARTNET.BAT loads the network drivers.  Group 2's filenames
  978.           are for the configuration files on my computer.  Filenames
  979.           within the groups may be left blank.  The "Make Backup
  980.           Files on Save" option makes a backup of the file being
  981.           saved if a previous version exists on disk already, adding
  982.           .BAK as the file extension.  The configuration file, whose
  983.           pathname is in the dialog's title, is saved when the OK
  984.           button or any of the Group buttons are pressed.
  985.  
  986.  
  987.           Tools|Default Drive
  988.           -------------------
  989.                Allows the user to select a default drive for the
  990.           commands in the EdIt! menu (see "Command Line Options
  991.           (/Dd)").  Additionally, the user has the option of
  992.           assigning a drive letter to a LANtastic network resource.
  993.           EdIt! does this by executing the following two commands:
  994.  
  995.                NET/NOERROR UNUSE [driveletter]:
  996.                NET USE [driveletter]: [resource path name]
  997.  
  998.           LANtastic resource pathnames take the form of
  999.           "\\[server_name]\[resource_name]", as in
  1000.           "\\HOST1\C-DRIVE".  Note that the NET.EXE file, usually
  1001.           found in the \LANTASTI directory, must be in your PATH
  1002.           statement in order to use the NET USE command.
  1003.  
  1004.  
  1005.           EdIt! v1.0                                           Page 13
  1006.           ------------------------------------------------------------
  1007.  
  1008.           Tools|Run Net...
  1009.           ----------------
  1010.                Runs the LANtastic program NET.EXE.  EdIt! assumes it
  1011.           is in a directory on the user's PATH.
  1012.  
  1013.  
  1014.           Tools|Run Net Manager...
  1015.           ------------------------
  1016.                Runs the LANtastic program NET_MGR.EXE.  EdIt! assumes
  1017.           it is in a directory on the user's PATH.
  1018.  
  1019.  
  1020.           EdIt! MENU:
  1021.  
  1022.           EdIt!|System Files / Windows Files / File Group [#]
  1023.           ---------------------------------------------------
  1024.                Works the same as the "/S," "/W," and "/[#]" command
  1025.           line options, respectively (see "Command Line Options").
  1026.  
  1027.  
  1028.           HELP MENU:
  1029.  
  1030.           Help|About
  1031.           ----------
  1032.                Displays version, copyright, serial number, and
  1033.           registration information, as well as the number of days this
  1034.           evaluation copy of EdIt! has been in use.
  1035.  
  1036.  
  1037.           Help|Registration Info...
  1038.           -------------------------
  1039.                Displays a dialog containing a short description of
  1040.           shareware along with an option to open this EDIT!.DOC file,
  1041.           providing it is located in the same directory as either the
  1042.           ED.EXE file or the EDIT!.CFG file.
  1043.  
  1044.  
  1045.           Help|Print Registration Form...
  1046.           -------------------------------
  1047.                Opens a dialog to print the registration form for
  1048.           EdIt!, which is formatted just like this document (59 lines
  1049.           per page, 60 characters wide plus a 10 character margin).
  1050.  
  1051.  
  1052.  
  1053.           Technichal Notes/Troubleshooting
  1054.           ================================
  1055.  
  1056.           Reformatting
  1057.           ------------
  1058.                There is a known bug in EdIt! that when the user is
  1059.                editing "large" files (over 30k or so) and is near the
  1060.           end of the document, formatting may not continue to the end
  1061.           of the "current paragraph," or may continue beyond the end
  1062.           of the paragraph.  I had delayed the release of EdIt! to
  1063.  
  1064.           EdIt! v1.0                                           Page 14
  1065.           ------------------------------------------------------------
  1066.  
  1067.           look for the bug, but decided that since the program's
  1068.           intent is to be used on batch files and small to medium
  1069.           text files, this would probably not pose much of a
  1070.           problem.
  1071.  
  1072.  
  1073.           TSRs
  1074.           ----
  1075.                EdIt! should work with most TSRs, although there are
  1076.           bound to be a few exceptions.  One appears to be a file
  1077.           named CALC.COM dated 6-1-88 at 12:00, a resident
  1078.           calculator.  This TSR causes the machine to hang when
  1079.           popped up over EdIt!.  Some TSRs may "trap" certain keys
  1080.           and prevent them from working, such as Close-Up v4.01's
  1081.           Customer program.  Norton's SmartCan has an interesting
  1082.           problem with EdIt!--occasionally the computer will beep
  1083.           twice when running EdIt!, usually when first loading or
  1084.           printing.  This is SmartCan beeping, I am told, to indicate
  1085.           a problem deleting a file.  Since EdIt! does not delete any
  1086.           files during these operations, I do not have a solution. If
  1087.           you find any other conflicts, please let me know.
  1088.  
  1089.  
  1090.           HOW TO CONTACT THE AUTHOR
  1091.           =========================
  1092.                While I am not averse to talking to customers, my
  1093.           present situation makes this a bit difficult.  I am a
  1094.           college student (Pepperdine U.), which unfortunately
  1095.           prevents me from having a permanent phone number.  I would
  1096.           be more than happy to provide support via the following
  1097.           channels:
  1098.  
  1099.           INTERNET:  My address is "syates@pepperdine.edu", BUT (!) I
  1100.                am only here when classes are in session.  Please only
  1101.                leave messages here from 11/1/93 to 12/1/93, and from
  1102.                1/15/94 to 4/10/94.  I probably will not get messages
  1103.                left for me outside of those dates, but I check my
  1104.                mail virtually every day when I'm there.  Although
  1105.                there is a slight delay, you can also send mail to
  1106.                71551.2257@compuserve.com (note the periods) or
  1107.                steveyates@delphi.com.
  1108.  
  1109.           DELPHI:  My username is STEVEYATES, and you can leave me
  1110.                e-mail or post a note in the PC Forum.
  1111.  
  1112.           COMPUSERVE:  My Compuserve ID is 71551,2257.
  1113.  
  1114.                One way that's guaranteed to work (well, OK, maybe
  1115.           not) is the US Mail, but again, please do not try to call
  1116.           since I will not be there:
  1117.  
  1118.                            Steve Yates
  1119.                            279 Main Street
  1120.                            Glen Ellyn, IL  60137-5353
  1121.  
  1122.                                -End of Document-